home *** CD-ROM | disk | FTP | other *** search
- <?xml version="1.0" encoding="UTF-8" standalone="no"?>
- <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
- <html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
- <title>11.7.  CML Explorer</title>
- <link rel="stylesheet" href="gimp-help-plain.css" type="text/css" />
- <link rel="stylesheet" href="gimp-help-screen.css" type="text/css" />
- <link rel="stylesheet" href="gimp-help-custom.css" type="text/css" />
- <link rel="alternate stylesheet" href="gimp22.css" type="text/css" title="gimp22" />
- <meta name="generator" content="DocBook XSL Stylesheets V1.73.2" />
- <link rel="start" href="index.html" title="GNU Image Manipulation Program" />
- <link rel="up" href="filters-render.html" title="11.  Rendering Filters" />
- <link rel="prev" href="plug-in-diffraction.html" title="11.6.  Diffraction Patterns" />
- <link rel="next" href="plug-in-grid.html" title="11.8.  Grid" />
- </head>
- <body>
- <div class="navheader">
- <table width="100%" summary="Navigation header">
- <tr>
- <th colspan="3" align="center">11.7. 
- <span lang="en" xml:lang="en">CML Explorer</span>
- </th>
- </tr>
- <tr>
- <td width="20%" align="left"><a accesskey="p" href="plug-in-diffraction.html"><img src="../images/prev.png" alt="Prev" /></a> </td>
- <th width="60%" align="center">11. 
- <span lang="en" xml:lang="en">Rendering Filters</span>
- </th>
- <td width="20%" align="right"> <a accesskey="n" href="plug-in-grid.html"><img src="../images/next.png" alt="Next" /></a></td>
- </tr>
- </table>
- <hr />
- </div>
- <div class="sect2" lang="en" xml:lang="en">
- <div class="titlepage">
- <div>
- <div>
- <h3 class="title"><a id="plug-in-cml-explorer"></a>11.7. 
- <span lang="en" xml:lang="en">CML Explorer</span>
- </h3>
- </div>
- <div>
- <div class="revhistory">
- <table border="1" width="100%" summary="Revision history">
- <tr>
- <th align="left" valign="top" colspan="3">
- <b>Revision History</b>
- </th>
- </tr>
- <tr>
- <td align="left">Revision $Revision: 2436 $</td>
- <td align="left">2006-12-13</td>
- <td align="left">j.h</td>
- </tr>
- </table>
- </div>
- </div>
- </div>
- </div>
- <a id="id2771763" class="indexterm"></a>
- <a id="id2771780" class="indexterm"></a>
- <div class="sect3" lang="en" xml:lang="en">
- <div class="titlepage">
- <div>
- <div>
- <h4 class="title"><a id="id2771789"></a>11.7.1. 
- <span lang="en" xml:lang="en">Overview</span>
- </h4>
- </div>
- </div>
- </div>
- <div class="figure">
- <a id="id2771800"></a>
- <p class="title">
- <b>Figure 16.244. 
- <span lang="en" xml:lang="en">
- Example for the “<span class="quote">CML Explorer</span>” filter
- </span>
- </b>
- </p>
- <div class="figure-contents">
- <div class="mediaobject">
- <img src="../images/filters/examples/render-taj-cmlexplorer.jpg" alt="Example for the CML Explorer filter" />
- <div class="caption">
- <p>
- Filter “<span class="quote">CML Explorer</span>” applied with default options
- </p>
- </div>
- </div>
- </div>
- </div>
- <br class="figure-break" />
- <p>
- This filter is the king of texture creating filters. It is extremely
- efficient but very complex. It uses a mathematical method named Cellular
- Automata.
- <a class="ulink" href="http://en.wikipedia.org/wiki/Cellular_Automata" target="_top">
- cellular_automata
- </a>.
- </p>
- </div>
- <div class="sect3" lang="en" xml:lang="en">
- <div class="titlepage">
- <div>
- <div>
- <h4 class="title"><a id="id2771864"></a>11.7.2. 
- <span lang="en" xml:lang="en">Starting filter</span>
- </h4>
- </div>
- </div>
- </div>
- <p>
- You can find this filter from the image menu through
- <span class="guimenu"><span class="accel">F</span>ilters</span> ‚Üí <span class="guisubmenu"><span class="accel">R</span>ender</span> ‚Üí <span class="guisubmenu"><span class="accel">P</span>attern</span> ‚Üí <span class="guimenuitem">CML <span class="accel">E</span>xplorer</span>
- </p>
- </div>
- <div class="sect3" lang="en" xml:lang="en">
- <div class="titlepage">
- <div>
- <div>
- <h4 class="title"><a id="id2771920"></a>11.7.3. 
- <span lang="en" xml:lang="en">Options</span>
- </h4>
- </div>
- </div>
- </div>
- <div class="variablelist">
- <dl>
- <dt>
- <span class="term">General Options</span>
- </dt>
- <dd>
- <div class="figure">
- <a id="id2771943"></a>
- <p class="title">
- <b>Figure 16.245. 
- <span lang="en" xml:lang="en">
- “<span class="quote">CML Explorer</span>” filter options(Hue)
- </span>
- </b>
- </p>
- <div class="figure-contents">
- <div class="mediaobject">
- <img src="../images/filters/options-render-cmlexplorer1.png" alt="CML Explorer filter options(Hue)" />
- </div>
- </div>
- </div>
- <br class="figure-break" />
- <p>
- Filter options are distributed among
- <span class="guilabel">Hue</span>,<span class="guilabel">Saturation</span>,
- <span class="guilabel">Value</span>, <span class="guilabel">Advanced</span>,
- <span class="guilabel">others</span> and <span class="guilabel">Misc.ops</span>
- tabs. Some more options are available. They will be described
- in following section.
- </p>
- <div class="variablelist">
- <dl>
- <dt>
- <span class="term">Preview</span>
- </dt>
- <dd>
- <p>
- This filter offers you a Preview where you can see the
- result of your settings before they are applied to the
- image.
- </p>
- </dd>
- <dt>
- <span class="term">
- New seed; Fix seed; Random seed
- </span>
- </dt>
- <dd>
- <p>
- Random plays a large part in creating patterns. With these
- options, you can influence the way random is generated. By
- clicking on the <span class="guibutton">New seed</span> button, you
- can force random to use a new source of random. The preview
- will show you the result.
- <span class="guibutton">Fix seed</span> lets you keep the same seed
- and so to reproduce the same effect with the filter.
- <span class="guibutton">Random seed</span> generates a random seed
- at random.
- </p>
- </dd>
- <dt>
- <span class="term">Open; Save</span>
- </dt>
- <dd>
- <p>
- With these both command buttons you can save pattern
- settings in a file, and to get them back later.
- </p>
- </dd>
- </dl>
- </div>
- </dd>
- <dt>
- <span class="term">Hue tab</span>
- </dt>
- <dd>
- <p>
- This filter works in the <a class="link" href="glossary.html#glossary-hsv" title="HSV">HSV</a> color model. In this tab, you
- can set options for Hue.
- </p>
- <div class="variablelist">
- <dl>
- <dt>
- <span class="term">Function type</span>
- </dt>
- <dd>
- <p>
- In this drop-down list, you can select the method that
- will be used to treat the current layer. These methods
- are:
- </p>
- <div class="itemizedlist">
- <ul type="disc">
- <li>
- <p>
- <span class="guilabel">Keep image's values</span>: With this
- option, image hue values will be kept.
- </p>
- </li>
- <li>
- <p>
- <span class="guilabel">Keep the first value</span>: With this
- option, starting color will be standard cyan.
- </p>
- </li>
- <li>
- <p>
- <span class="guilabel">Fill with k parameter</span>,
- <span class="guilabel">k{x(1-x)}^p</span>,
- <span class="guilabel">k{x(1-x)}^p stepped</span>,
- <span class="guilabel">kx^p</span>,
- <span class="guilabel">kx^p stepped</span>,
- <span class="guilabel">k(1-x^p)</span>,
- <span class="guilabel">k(1-x^p) stepped</span>: pattern look
- will depend on <em class="parameter"><code>k</code></em> that you will
- set later in options.
- </p>
- </li>
- <li>
- <p>
- <span class="guilabel">Delta function</span>,
- <span class="guilabel">Delta function stepped</span>: FIXME
- </p>
- </li>
- <li>
- <p>
- <span class="guilabel">sin^p based Function</span>,
- <span class="guilabel">sin^p stepped</span>: These options
- create wave-like patterns, like aurora borealis or
- curtain folds.
- </p>
- </li>
- </ul>
- </div>
- </dd>
- <dt>
- <span class="term">Composition</span>
- </dt>
- <dd>
- <p>
- Here, these options concern Hue. You can select:
- </p>
- <p>
- <span class="guilabel">None</span>, <span class="guilabel">Max(x, -)</span>,
- <span class="guilabel">Max(x+d, -)</span>,
- <span class="guilabel">Max(x-d, -)</span>,
- <span class="guilabel">Min(x, -)</span>,
- <span class="guilabel">Min(x+d, -)</span>,
- <span class="guilabel">Min(x-d, -)</span>,
- <span class="guilabel">Max(x+d, -), (x < 0,5)</span>,
- <span class="guilabel">Max(x+d, -), (0,5 < x)</span>,
- <span class="guilabel">Max(x-d, -), (x < 0,5)</span>,
- <span class="guilabel">Max(x-d, -), (0,5 < x)</span>,
- <span class="guilabel">Min(x+d, -), (x < 0,5)</span>,
- <span class="guilabel">Min(x+d, -), (0,5 < x)</span>,
- <span class="guilabel">Min(x-d, -), (x < 0,5)</span> and
- <span class="guilabel">Min(x-d, -), (0,5 < x)</span>.
- </p>
- <p>
- A book could be filled with results of all these
- functions. Please, experiment!
- </p>
- </dd>
- <dt>
- <span class="term">Misc. Arrange</span>
- </dt>
- <dd>
- <p>
- This drop-down list offers you some other parameters:
- </p>
- <p>
- <span class="guilabel">Standard</span>,
- <span class="guilabel">Use average value</span>,
- <span class="guilabel">Use reverse value</span>,
- <span class="guilabel">With random power (0,10)</span>,
- <span class="guilabel">With random power (0,1)</span>,
- <span class="guilabel">with gradient power (0,1)</span>,
- <span class="guilabel">Multiply rand. value (0,1)</span>,
- <span class="guilabel">Multiply rand. value (0,2)</span>,
- <span class="guilabel">Multiply gradient (0,1)</span> and
- <span class="guilabel">With p and random (0,1)</span>.
- </p>
- <p>
- Also a book would be necessary to explain all
- possibilities of these parameters.
- </p>
- </dd>
- <dt>
- <span class="term">Use cyclic range</span>
- </dt>
- <dd>
- <p>
- //TODO
- </p>
- </dd>
- <dt>
- <span class="term">Mod. rate</span>
- </dt>
- <dd>
- <p>
- With this slider and the input box, you can set
- modification rate from 0.0 to 1.0. Low value results in a
- lined pattern.
- </p>
- </dd>
- <dt>
- <span class="term">Env. sensitivity</span>
- </dt>
- <dd>
- <p>
- Value is from 0.0 to 1.0
- </p>
- </dd>
- <dt>
- <span class="term">Diffusion dist.</span>
- </dt>
- <dd>
- <p>
- Diffusion distance: from 2 to 10.
- </p>
- </dd>
- <dt>
- <span class="term"># of subranges</span>
- </dt>
- <dd>
- <p>
- Number of sub-rangers: from 1 to 10.
- </p>
- </dd>
- <dt>
- <span class="term">(P)ower factor</span>
- </dt>
- <dd>
- <p>
- With this option you can influence the
- <span class="guilabel">Function types</span> using the
- <em class="parameter"><code>p</code></em> parameter. Value from 0.0 to 10.0.
- </p>
- </dd>
- <dt>
- <span class="term">k Parameter</span>
- </dt>
- <dd>
- <p>
- With this option you can influence the
- <span class="guilabel">Function types</span> using the
- <em class="parameter"><code>k</code></em> parameter. Value from 0.0 to 10.0.
- </p>
- </dd>
- <dt>
- <span class="term">Range low</span>
- </dt>
- <dd>
- <p>
- Set lower limit of hue that will be used for calculation.
- values vary from 0.0 to 1.0.
- </p>
- </dd>
- <dt>
- <span class="term">Range high</span>
- </dt>
- <dd>
- <p>
- Set the upper limit of hue that will be used for
- calculation. Variations are from 0.0 to 1.0.
- </p>
- </dd>
- <dt>
- <span class="term">Plot a graph of the settings</span>
- </dt>
- <dd>
- <p>
- By clicking on this large button, you can open a window
- that displays the graph of hue present settings.
- </p>
- <div class="figure">
- <a id="id2772738"></a>
- <p class="title">
- <b>Figure 16.246. 
- <span lang="en" xml:lang="en">
- Function graph of present settings
- </span>
- </b>
- </p>
- <div class="figure-contents">
- <div class="mediaobject">
- <img src="../images/filters/options-render-cmlexplorer1a.png" alt="Function graph of present settings" />
- </div>
- </div>
- </div>
- <br class="figure-break" />
- </dd>
- </dl>
- </div>
- </dd>
- <dt>
- <span class="term">Saturation tab</span>
- </dt>
- <dd>
- <div class="figure">
- <a id="id2772782"></a>
- <p class="title">
- <b>Figure 16.247. 
- <span lang="en" xml:lang="en">
- “<span class="quote">CML Explorer</span>” filter options(Saturation)
- </span>
- </b>
- </p>
- <div class="figure-contents">
- <div class="mediaobject">
- <img src="../images/filters/options-render-cmlexplorer2.png" alt="CML Explorer filter options(Saturation)" />
- </div>
- </div>
- </div>
- <br class="figure-break" />
- <p>
- In this tab, you can set how Saturation component of the HSV
- color model will be used in pattern calculation.
- </p>
- <p>
- These options are similar to Hue tab options.
- </p>
- </dd>
- <dt>
- <span class="term">Value tab</span>
- </dt>
- <dd>
- <div class="figure">
- <a id="id2772841"></a>
- <p class="title">
- <b>Figure 16.248. 
- <span lang="en" xml:lang="en">
- “<span class="quote">CML Explorer</span>” filter options (Value)
- </span>
- </b>
- </p>
- <div class="figure-contents">
- <div class="mediaobject">
- <img src="../images/filters/options-render-cmlexplorer3.png" alt="CML Explorer filter options (Value)" />
- </div>
- </div>
- </div>
- <br class="figure-break" />
- <p>
- In this tab, you can set how the Value (Luminosity) component of
- the HSV color model will be used in pattern calculation.
- </p>
- <p>
- These options are similar to Hue tab options.
- </p>
- </dd>
- <dt>
- <span class="term">Advanced tab</span>
- </dt>
- <dd>
- <div class="figure">
- <a id="id2772901"></a>
- <p class="title">
- <b>Figure 16.249. 
- <span lang="en" xml:lang="en">
- “<span class="quote">CML Explorer</span>” filter options (Advanced)
- </span>
- </b>
- </p>
- <div class="figure-contents">
- <div class="mediaobject">
- <img src="../images/filters/options-render-cmlexplorer4.png" alt="CML Explorer filter options (Advanced)" />
- </div>
- </div>
- </div>
- <br class="figure-break" />
- <p>
- These tab settings apply to the three HSV channels.
- </p>
- <div class="variablelist">
- <dl>
- <dt>
- <span class="term">Channel Sensitivity</span>
- </dt>
- <dd>
- <p>// TODO</p>
- </dd>
- <dt>
- <span class="term">Mutation rate</span>
- </dt>
- <dd>
- <p>// TODO</p>
- </dd>
- <dt>
- <span class="term">Mutation distance</span>
- </dt>
- <dd>
- <p>//TODO</p>
- </dd>
- </dl>
- </div>
- </dd>
- <dt>
- <span class="term">Others tab</span>
- </dt>
- <dd>
- <div class="figure">
- <a id="id2773009"></a>
- <p class="title">
- <b>Figure 16.250. 
- <span lang="en" xml:lang="en">
- “<span class="quote">CML Explorer</span>” filter options (Others)
- </span>
- </b>
- </p>
- <div class="figure-contents">
- <div class="mediaobject">
- <img src="../images/filters/options-render-cmlexplorer5.png" alt="CML Explorer filter options (Others)" />
- </div>
- </div>
- </div>
- <br class="figure-break" />
- <p>
- In this tab, you can find various parameters about image display
- and random intervention.
- </p>
- <div class="variablelist">
- <dl>
- <dt>
- <span class="term">Initial value</span>
- </dt>
- <dd>
- <p>// TODO</p>
- </dd>
- <dt>
- <span class="term">Zoom factor</span>
- </dt>
- <dd>
- <p>// TODO</p>
- </dd>
- <dt>
- <span class="term">Start offset</span>
- </dt>
- <dd>
- <p>// TODO</p>
- </dd>
- <dt>
- <span class="term">Seed of random</span>
- </dt>
- <dd>
- <p>// TODO</p>
- </dd>
- </dl>
- </div>
- </dd>
- <dt>
- <span class="term">Miscellaneous options tab</span>
- </dt>
- <dd>
- <div class="figure">
- <a id="id2773135"></a>
- <p class="title">
- <b>Figure 16.251. 
- <span lang="en" xml:lang="en">
- “<span class="quote">CML Explorer</span>” filter options (Misc.ops)
- </span>
- </b>
- </p>
- <div class="figure-contents">
- <div class="mediaobject">
- <img src="../images/filters/options-render-cmlexplorer6.png" alt="CML Explorer filter options (Misc.ops)" />
- </div>
- </div>
- </div>
- <br class="figure-break" />
- <p>
- In this tab you can find various options about copy and loading.
- </p>
- <div class="variablelist">
- <dl>
- <dt>
- <span class="term">Copy settings</span>
- </dt>
- <dd>
- <p>
- These options allow you to transfer information from
- one of the HSV channel to another one.
- </p>
- </dd>
- <dt>
- <span class="term">Selective load setting</span>
- </dt>
- <dd>
- <p>
- With the <span class="guibutton">Open</span> button of this
- filter, you can load previously loaded settings. If you
- don't want to load all of them, you can select a source
- and a destination channel here.
- </p>
- </dd>
- </dl>
- </div>
- </dd>
- </dl>
- </div>
- </div>
- </div>
- <div class="navfooter">
- <hr />
- <table width="100%" summary="Navigation footer">
- <tr>
- <td width="40%" align="left"><a accesskey="p" href="plug-in-diffraction.html"><img src="../images/prev.png" alt="Prev" /></a> </td>
- <td width="20%" align="center">
- <a accesskey="u" href="filters-render.html">
- <img src="../images/up.png" alt="Up" />
- </a>
- </td>
- <td width="40%" align="right"> <a accesskey="n" href="plug-in-grid.html"><img src="../images/next.png" alt="Next" /></a></td>
- </tr>
- <tr>
- <td width="40%" align="left" valign="top"><a accesskey="p" href="plug-in-diffraction.html">11.6. 
- <span lang="en" xml:lang="en">Diffraction Patterns</span>
- </a> </td>
- <td width="20%" align="center">
- <a accesskey="h" href="index.html">
- <img src="../images/home.png" alt="Home" />
- </a>
- </td>
- <td width="40%" align="right" valign="top"> <a accesskey="n" href="plug-in-grid.html">11.8. 
- <span lang="en" xml:lang="en">Grid</span>
- </a></td>
- </tr>
- </table>
- </div>
- </body>
- </html>
-